Skip to content

Font makes feature names unreadable #12696

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
romainmenke opened this issue Mar 3, 2025 · 2 comments
Open

Font makes feature names unreadable #12696

romainmenke opened this issue Mar 3, 2025 · 2 comments
Labels
♿ a11y An MDN Web Docs accessible by everyone idle p2 We want to address this but may have other higher priority items. redesign issues related to the new design typography Issues related to font color/decoration/size/weight

Comments

@romainmenke
Copy link

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/Window/cancelIdleCallback

What specific section or headline is this issue about?

Title

What information was incorrect, unhelpful, or incomplete?

The font that was used

What did you expect to see?

A readable and accessible font

Do you have any supporting links, references, or citations?

Image

It is impossible to distinguish upper case i from lower case l
This is not ideal given how frequently these appear together in camel cased feature names.

Do you have anything more you want to share?

No response

MDN metadata

Page report details
@romainmenke romainmenke added the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Mar 3, 2025
@bsmth bsmth transferred this issue from mdn/content Mar 3, 2025
@bsmth bsmth added ♿ a11y An MDN Web Docs accessible by everyone typography Issues related to font color/decoration/size/weight labels Mar 3, 2025
@argl argl added p2 We want to address this but may have other higher priority items. involves: UX redesign issues related to the new design and removed needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Mar 3, 2025
@Bashamega
Copy link

Hello @caugner
I propose using a new font from Google Fonts, that will make the text more readable.
This is a list of some fonts that I came up with, I can file a PR for it once we choose an accessible font.
Fonts:

Font Name Type Notes
JetBrains Mono Monospace Excellent for devs; very clear capital "I" with horizontal bars
Fira Code Monospace Also great for coding; clear and sharp glyphs
IBM Plex Mono Monospace Professional, modern, and very readable
Source Code Pro Monospace Designed by Adobe, widely used and very clean
Courier Prime Monospace Traditional typewriter style; super clear distinctions
Recursive Variable Flexible with a mono option, designed for readability
Inconsolata Monospace Very readable, slightly more stylized

@caugner
Copy link
Contributor

caugner commented Apr 11, 2025

I'm happy to share that we're working on a front-end rewrite, which currently renders the title mentioned above like this:

Image

@github-actions github-actions bot added the idle label May 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
♿ a11y An MDN Web Docs accessible by everyone idle p2 We want to address this but may have other higher priority items. redesign issues related to the new design typography Issues related to font color/decoration/size/weight
Projects
None yet
Development

No branches or pull requests

5 participants